Skip to content

docs(maintaining): codify S5 retro items 1-3 (Discussion 208) - #317

Open
umermjd11 wants to merge 2 commits into
InfiniteZeroFoundation:developfrom
umermjd11:docs/maintaining-s5-retro
Open

umermjd11 wants to merge 2 commits into
InfiniteZeroFoundation:developfrom
umermjd11:docs/maintaining-s5-retro

Conversation

@umermjd11

Copy link
Copy Markdown
Collaborator

Writes the three process changes agreed in the S5 retro of Discussion 208 into Developer/MAINTAINING.md. They're worded with @Santiagocetran's conditions from his reply. @robertocarlous agreed to all three.

This PR stays a draft until the Nov 7 objection window closes.

Docs only. One file changed.

Retro item Where What it says
No. 1: approver queues No. 4.4, path A Whoever gives the final required approval queues the PR once every check and sign-off is in, unless their review says otherwise. If they can't queue it, or aren't eligible to, they hand that step to a named eligible maintainer in the review (Santiago). When the last approval is a foundry/src/** second sign-off from Umer or Abraham, Umer may queue the PR himself, and otherwise the peer reviewer does.
No. 2: 2-day window covers second keys and re-reviews No. 4.1 Applies the 2-working-day window to second sign-offs and re-reviews. It's a time to respond or escalate in, not a deadline to finish the review: if a review needs more time, the reviewer says so and states what's left (Santiago). A second key waiting more than 2 days gets pinged on the PR, and Umer or Abraham can route it to a security reviewer under No. 4.2, by default @Abidoyesimze.
No. 3: fewest-reviews tie-breaker No. 4.1 A tie-breaker among eligible reviewers only. The No. 3 skillset table and availability still decide who is eligible, outstanding reviews and how complex they are also count, and recusal or escalation stays valid (Santiago). Still no fixed rotation.

Retro item No. 4 (Umer's review backlog) is an action item, not process, so it isn't in this file.

Per No. 1, this needs a peer's approval. The PR author is umermjd11, so umeradl can't approve it.

🤖 Generated with Claude Code

- No. 4.4: whoever gives the final approval queues the PR, or hands that
  step to a named eligible maintainer; Umer may queue PRs whose second
  sign-off came last, otherwise the peer reviewer does.
- No. 4.1: the 2-working-day window covers second sign-offs and re-reviews,
  as a time to respond or escalate in; second keys waiting too long are
  routed to a security reviewer (default @Abidoyesimze).
- No. 4.1: fewest-reviews tie-breaker for first reviews, among eligible
  reviewers only; skillset, availability and recusal still apply.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@umeradl
umeradl marked this pull request as ready for review November 7, 2026 20:13
@umeradl
umeradl self-requested a review as a code owner November 7, 2026 20:13
@umeradl

umeradl commented Nov 7, 2026

Copy link
Copy Markdown
Member

The objection window closed on Nov 7 with no objections: @robertocarlous and @Santiagocetran both agreed to retro items 1–3 in Discussion 208. So this is now out of draft. CI is green at b06a029, and the PR changes only Developer/MAINTAINING.md.

@robertocarlous or @Santiagocetran, could one of you review it? Whoever gives the approval can queue it, which is retro item 1 itself.

@chatgpt-codex-connector

chatgpt-codex-connector Bot commented Nov 7, 2026 •

Copy link
Copy Markdown
Codex Review Summary: ✅ Completed

This comment shows the latest Codex review activity on this pull request.

Review Status Commit Review trigger
📝 Code Review ✅ Completed 2026-11-07T20:16:17.868317Z b06a029 Draft marked ready
ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: b06a029be4

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread Developer/MAINTAINING.md Outdated
**The 2-working-day window covers every review request**, not just the first response: the `foundry/src/**` second sign-off ([No. 4.2](#42-review-depth)) and re-reviews after the author pushes new commits (which dismiss stale approvals, [No. 2](#2-what-github-enforces)) count too. It's a window to respond or escalate in, not a deadline to finish the review:

- If a review needs more time, the reviewer says so on the PR within the window and states what's left to check.
- If a second sign-off has waited more than 2 working days, the peer reviewer pings it on the PR. Umer or Abraham can then route it to a security reviewer ([No. 4.2](#42-review-depth)), by default @Abidoyesimze.

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Keep the fallback second sign-off independent

For a foundry/src/** PR authored by @robertocarlous, No. 3 makes @Abidoyesimze the peer reviewer; if the Umer/Abraham sign-off is late, this default routes the replacement to the same person, so the PR can proceed with only one independent review despite No. 4.2 requiring the peer review plus a second sign-off. Exclude the existing peer from this fallback or choose another eligible security reviewer.

Useful? React with 👍 / 👎.

Comment thread Developer/MAINTAINING.md
### 4.4 Merge paths

- **(A) GitHub-side merge commit — the default.** The reviewer approves, CI is green, and the reviewer clicks **Merge when ready** to add the PR to the merge queue. The queue re-runs `CI OK` on the PR merged onto the latest `develop` and lands it with a merge commit. If that run fails, the queue drops the PR and leaves `develop` untouched; fix it on the PR branch and queue it again. If the reviewer wants something changed first, they push the fix onto the PR branch (or open a small follow-up PR). The last-push rule then sends the final approval to someone else.
- **(A) GitHub-side merge commit — the default.** The reviewer approves, CI is green, and the reviewer clicks **Merge when ready** to add the PR to the merge queue. **The approver queues by default:** whoever gives the final required approval queues the PR once every required check and sign-off is in, unless their review says otherwise. If they can't queue it, or aren't eligible to merge it under [No. 1](#1-the-rule) (for example, they co-authored it), they hand the step to a named eligible maintainer in the review, so no approved PR sits without an owner. When the last thing in is a `foundry/src/**` second sign-off from Umer or Abraham, Umer may queue it himself, and otherwise the peer reviewer does. The queue re-runs `CI OK` on the PR merged onto the latest `develop` and lands it with a merge commit. If that run fails, the queue drops the PR and leaves `develop` untouched; fix it on the PR branch and queue it again. If the reviewer wants something changed first, they push the fix onto the PR branch (or open a small follow-up PR). The last-push rule then sends the final approval to someone else.

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Gate queueing on the approver or a named delegate

When a non-approver runs the required din-pr-merge skill, its A3 enqueues on the operator's go-ahead and the skill permits any non-author/co-author to run; it never verifies that the operator gave the final approval or was named in a handoff. This lets the normal tooling bypass the ownership rule in this paragraph, so update the skill to require the final approver or an explicitly named delegate before enqueueing.

Useful? React with 👍 / 👎.

…e peer

For @robertocarlous and @Abidoyesimze PRs touching foundry/src/**, the
second sign-off is always @umeradl or @abrahamnash. Routing to a security
reviewer applies only to other authors, and that reviewer can't be the
PR's author or its peer reviewer. Drops the "by default @Abidoyesimze"
fallback, which would have made him both peer and second sign-off on
Roberto's PRs, or the second sign-off on his own (Codex review No. 1).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants